IRIX Base Documentation 1998 November/IRIX 6.5.2 Base Documentation November 1998.img/usr/share/catman/p_man/cat3/Xm/XmList.z/XmList

Text File | 1998-10-30 | 163KB | 2,377 lines

     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



     NNNNAAAAMMMMEEEE
          XXXXmmmmLLLLiiiisssstttt - The List widget class

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          #include <Xm/List.h>

     VVVVEEEERRRRSSSSIIIIOOOONNNN
          This page documents Motif 2.1.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          List allows a user to select one or more items from a group
          of choices. Items are selected from the list in a variety of
          ways, using both the pointer and the keyboard.  List
          operates on an array of compound strings that are defined by
          the application.  Each compound string becomes an item in
          the List, with the first compound string becoming the item
          in position 1, the second becoming the item in position 2,
          and so on.

          Specifying the number of items that are visible sets the
          size of the List.  If the number of visible items is not
          specified, the height of the list controls the number of
          visible items. Each item assumes the height of the tallest
          element in the list.  To create a list that allows the user
          to scroll easily through a large number of items, use the
          XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddLLLLiiiisssstttt convenience function.

          To select items, move the pointer or cursor to the desired
          item and press the <<<<BBBBttttnnnn1111>>>> mouse button or the key defined as
          <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>. There are several styles of selection behavior,
          and they all highlight the selected item or items by
          displaying them in inverse colors. An appropriate callback
          is invoked to notify the application of the user's choice.
          The application then takes whatever action is required for
          the specified selection.  When a List is insensitive, all of
          the list items are displayed in a stippled fill pattern.

          List uses the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e, _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e, and
          _X_m_Q_T_n_a_v_i_g_a_t_o_r traits, and holds the _X_m_Q_T_t_r_a_n_s_f_e_r trait.

        SSSSeeeelllleeeeccccttttiiiioooonnnn
          Each list has one of four selection models:

             +o  Single Select

             +o  Browse Select

             +o  Multiple Select

             +o  Extended Select

          In Single Select and Browse Select, at most one item is



     Page 1                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          selected at a time.  In Single Select, pressing <<<<BBBBttttnnnn1111>>>> on an
          item toggles its selection state and deselects any other
          selected item.  In Browse Select, pressing <<<<BBBBttttnnnn1111>>>> on an item
          selects it and deselects any other selected item; dragging
          <<<<BBBBttttnnnn1111>>>> moves the selection as the pointer is moved.
          Releasing <<<<BBBBttttnnnn1111>>>> on an item moves the location cursor to
          that item.

          In Multiple Select, any number of items can be selected at a
          time.  Pressing <<<<BBBBttttnnnn1111>>>> on an item toggles its selection
          state but does not deselect any other selected items.

          In Extended Select, any number of items can be selected at a
          time, and the user can easily select ranges of items.
          Pressing <<<<BBBBttttnnnn1111>>>> on an item selects it and deselects any
          other selected item.  Dragging <<<<BBBBttttnnnn1111>>>> or pressing or
          dragging <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111>>>> following a <<<<BBBBttttnnnn1111>>>> action selects all
          items between the item under the pointer and the item on
          which <<<<BBBBttttnnnn1111>>>> was pressed.  This action also deselects any
          other selected items outside that range.

          Extended Select also allows the user to select and deselect
          discontiguous ranges of items.  Pressing <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>> on an
          item toggles its selection state but does not deselect any
          other selected items.  Dragging <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>> or pressing or
          dragging <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111>>>> following a <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>> action sets
          the selection state of all items between the item under the
          pointer and the item on which <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>> was pressed to
          the state of the item on which <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>> was pressed.
          This action does not deselect any other selected items
          outside that range.

          All selection operations available from the mouse are also
          available from the keyboard.  List has two keyboard
          selection modes, Normal Mode and Add Mode.  In Normal Mode,
          navigation operations and <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> select the item at the
          location cursor and deselect any other selected items.  In
          Add Mode, navigation operations have no effect on selection,
          and <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> toggles the selection state of the item at
          the location cursor without deselecting any other selected
          items, except in Single Select.

          Single and Multiple Select use Add Mode, and Browse Select
          uses Normal Mode.

          Extended Select can use either mode; the user changes modes
          by pressing <<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>.  In Extended Select Normal Mode,
          pressing <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> has the same effect as pressing <<<<BBBBttttnnnn1111>>>>;
          <<<<oooossssffffEEEExxxxtttteeeennnndddd>>>> and shifted navigation have the same effect as
          pressing <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111>>>> following a <<<<BBBBttttnnnn1111>>>>action.  In
          Extended Select Add Mode, pressing <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> has the same
          effect as pressing <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>>; <<<<oooossssffffEEEExxxxtttteeeennnndddd>>>> and shifted



     Page 2                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          navigation have the same effect as pressing <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111>>>>
          following a <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111>>>>action.

          Normal Mode is indicated by a solid location cursor, and Add
          Mode is indicated by a dashed location cursor.

        DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
          List supports dragging of items from the List and transfer
          of items to the clipboard.  When the user presses BBBBTTTTrrrraaaannnnssssffffeeeerrrr
          on a selected item, the widget transfers all selected items.
          When the user presses BBBBTTTTrrrraaaannnnssssffffeeeerrrr on an unselected item, the
          widget transfers only that item.  Depending on the value of
          XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp, List can also support primary
          selection.

          When the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures are called, the
          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt member
          is NULL if the selected items are being transferred.  If the
          selected items are not being transferred, this member has
          the following value:  If a single item is being transferred,
          the value is an integer representing the position of the
          item in the List.  A value of 1 transfers the first item in
          the List; a value of 2 transfers the second item; and so on.
          If the entire contents of the List are being transferred,
          the value is -1.

          As a source of data, List supports the following targets and
          associated conversions of data to these targets:

          _l_o_c_a_l_e    If the _l_o_c_a_l_e target matches the widget's locale,
                    the widget transfers the selected list items in
                    the encoding of the locale.  Each item transferred
                    except the last includes a trailing separator.

          _C_O_M_P_O_U_N_D__T_E_X_T
                    The widget transfers the selected list items as
                    type _C_O_M_P_O_U_N_D__T_E_X_T.  Each item transferred except
                    the last includes a trailing separator.

          _S_T_R_I_N_G    The widget transfers the selected list items as
                    type _S_T_R_I_N_G.  Each item transferred except the
                    last includes a trailing separator.

          _T_E_X_T      If the selected list items are fully convertible
                    to the encoding of the locale, the widget
                    transfers the selected list items in the encoding
                    of the locale.  Otherwise, the widget transfers
                    the selected list items as type _C_O_M_P_O_U_N_D__T_E_X_T.
                    Each item transferred except the last includes a
                    trailing separator.

          ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS



     Page 3                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports for immediate transfer for the
                    _C_L_I_P_B_O_A_R_D selection.  These include
                    ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG.  If the selected list
                    items are fully convertible to _S_T_R_I_N_G, these also
                    include _S_T_R_I_N_G; otherwise, they also include
                    _C_O_M_P_O_U_N_D__T_E_X_T.

          ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG
                    The widget transfers the selected list items as a
                    compound string in Byte Stream format.  Each item
                    transferred except the last includes a trailing
                    separator.

          ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports for delayed transfer for the
                    _C_L_I_P_B_O_A_R_D selection.  This widget currently
                    supplies no targets for
                    ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS.

          ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets to be used as the value of the
                    DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
                    transfer.  These include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG,
                    _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale, _S_T_R_I_N_G,
                    _T_E_X_T, _B_A_C_K_G_R_O_U_N_D, and _F_O_R_E_G_R_O_U_N_D.

          ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
                    When the widget loses the selection, it deselects
                    all list items.

          As a source of data, List also supports the following
          standard Motif targets:

          _B_A_C_K_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L.

          _C_L_A_S_S     The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
                    transfers the contents as text in the current
                    locale.

          _C_L_I_E_N_T__W_I_N_D_O_W
                    The widget finds the first shell in the widget
                    hierarchy and transfers its window as type _W_I_N_D_O_W.

          _C_O_L_O_R_M_A_P  The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P.

          _F_O_R_E_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L.



     Page 4                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          _N_A_M_E      The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
                    transfers the contents as text in the current
                    locale.

          _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports.  These include the standard
                    targets in this list.  These also include
                    ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _C_O_M_P_O_U_N_D__T_E_X_T, the
                    encoding of the locale, _S_T_R_I_N_G, and _T_E_X_T.

          _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
                    the selection as type _I_N_T_E_G_E_R.

          ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
                    The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
                    or else the default text render table, as type
                    _S_T_R_I_N_G.

          ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
                    The widget transfers its encoding registry as type
                    _S_T_R_I_N_G.  The value is a list of NULL separated
                    items in the form of tag encoding pairs.  This
                    target symbolizes the transfer target for the
                    Motif Segment Encoding Registry.  Widgets and
                    applications can use this Registry to register
                    text encoding formats for specified render table
                    tags.  Applications access this Registry by
                    calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
                    XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.

          List has no widget class destination procedure.  Subclasses
          and the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are responsible
          for any data transfers to the widget.

        CCCCllllaaaasssssssseeeessss
          List inherits behavior, resources, and traits from CCCCoooorrrreeee and
          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee.

          The class pointer is _x_m_L_i_s_t_W_i_d_g_e_t_C_l_a_s_s.

          The class name is XXXXmmmmLLLLiiiisssstttt.

        NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
          The following table defines a set of widget resources used
          by the programmer to specify data. The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget. To reference a resource by name
          or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
          prefix and use the remaining letters. To specify one of the
          defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
          the XXXXmmmm prefix and use the remaining letters (in either



     Page 5                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          lowercase or uppercase, but include any underscores between
          words).  The codes in the access column indicate if the
          given resource can be set at creation time (C), set by using
          XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
          not applicable (N/A).

                                                        XXXXmmmmLLLLiiiisssstttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                           CCCCllllaaaassssssss                       TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                    AAAAcccccccceeeessssssss
          XmNautomaticSelection          XmCAutomaticSelection       XtEnum              False                      CSG
          XmNbrowseSelectionCallback     XmCCallback                 XtCallbackList      NULL                       C
          XmNdefaultActionCallback       XmCCallback                 XtCallbackList      NULL                       C
          XmNdestinationCallback         XmCCallback                 XtCallbackList      NULL                       C
          XmNdoubleClickInterval         XmCDoubleClickInterval      int                 dynamic                    CSG
          XmNextendedSelectionCallback   XmCCallback                 XtCallbackList      NULL                       C
          XmNfontList                    XmCFontList                 XmFontList          dynamic                    CSG
          XmNitemCount                   XmCItemCount                int                 0                          CSG
          XmNitems                       XmCItems                    XmStringTable       NULL                       CSG
          XmNlistMarginHeight            XmCListMarginHeight         Dimension           0                          CSG
          XmNlistMarginWidth             XmCListMarginWidth          Dimension           0                          CSG
          XmNlistSizePolicy              XmCListSizePolicy           unsigned char       XmVARIABLE                 CG
          XmNlistSpacing                 XmCListSpacing              Dimension           0                          CSG
          XmNmatchBehavior               XmCMatchBehavior            unsigned char       XmQUICK_NAVIGATE           CSG
          XmNmultipleSelectionCallback   XmCCallback                 XtCallbackList      NULL                       C
          XmNprimaryOwnership            XmCPrimaryOwnership         unsigned char       XmOWN_NEVER                CSG
          XmNrenderTable                 XmCRenderTable              XmRenderTable       dynamic                    CSG
          XmNscrollBarDisplayPolicy      XmCScrollBarDisplayPolicy   unsigned char       XmAS_NEEDED                CSG
          XmNselectColor                 XmCSelectColor              XmRSelectColor      XmREVERSED_GROUND_COLORS   CSG
          XmNselectedItemCount           XmCSelectedItemCount        int                 0                          CSG
          XmNselectedItems               XmCSelectedItems            XmStringTable       NULL                       CSG
          XmNselectedPositionCount       XmCSelectedPositionCount    int                 0                          CSG
          XmNselectedPositions           XmCSelectedPositions        unsigned int *      NULL                       CSG
          XmNselectionMode               XmCSelectionMode            unsigned char       dynamic                    CSG
          XmNselectionPolicy             XmCSelectionPolicy          unsigned char       XmBROWSE_SELECT            CSG
          XmNsingleSelectionCallback     XmCCallback                 XtCallbackList      NULL                       C
          XmNstringDirection             XmCStringDirection          XmStringDirection   dynamic                    CSG
          XmNtopItemPosition             XmCTopItemPosition          int                 1                          CSG
          XmNvisibleItemCount            XmCVisibleItemCount         int                 dynamic                    CSG

          XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn
                    Invokes either XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk or
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when <<<<BBBBttttnnnn1111>>>> is
                    pressed and the items that are shown as selected
                    change if the value is True (or XXXXmmmmAAAAUUUUTTTTOOOO) and the
                    selection mode is either XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT or
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT respectively.  If False
                    (XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT), no selection callbacks are
                    invoked until the user releases the mouse button.
                    See BBBBeeeehhhhaaaavvvviiiioooorrrr for further details on the
                    interaction of this resource with the selection
                    modes.

          XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk



     Page 6                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    Specifies a list of callbacks that is called when
                    an item is selected in the browse selection mode.
                    The reason is XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.

          XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks that is called when
                    an item is double clicked or <<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> is
                    pressed.  The reason is XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN.

          XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks called when the List
                    is the destination of a transfer operation.  The
                    type of the structure whose address is passed to
                    these callbacks is XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
                    The reason is XXXXmmmmCCCCRRRR____OOOOKKKK.

          XXXXmmmmNNNNddddoooouuuubbbblllleeeeCCCClllliiiicccckkkkIIIInnnntttteeeerrrrvvvvaaaallll
                    If a button click is followed by another button
                    click within the time span specified by this
                    resource (in milliseconds), the button clicks are
                    considered a double-click action, rather than two
                    single-click actions.  The value must not be
                    negative.  The default value is the display's
                    multiclick time.

          XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks that is called when
                    items are selected using the extended selection
                    mode.  The reason is XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT.

          XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
                    Specifies the font list associated with the list
                    items.  XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt is obsolete and exists only
                    for compatibility with previous releases. You
                    should now use XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee instead of
                    XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt. If both are specified, the render
                    table will take precedence. The font list is used
                    in conjunction with the
                    XXXXmmmmNNNNvvvviiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnnttttresource to determine the
                    height of the List widget.  If this value is NULL
                    at initialization, the parent hierarchy of the
                    widget is searched for a widget that holds the
                    _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait.  If such an ancestor
                    is found, the font list is initialized to the
                    XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor widget.
                    If no such widget is found, the default is
                    implementation dependent. Refer to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3)
                    for more information on a font list structure.

          XXXXmmmmNNNNiiiitttteeeemmmmCCCCoooouuuunnnntttt
                    Specifies the total number of items.  The value
                    must be the number of items in XXXXmmmmNNNNiiiitttteeeemmmmssss and must



     Page 7                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    not be negative.  It is automatically updated by
                    the list whenever an item is added to or deleted
                    from the list.

          XXXXmmmmNNNNiiiitttteeeemmmmssss  Points to an array of compound strings that are to
                    be displayed as the list items.  Refer to
                    XXXXmmmmSSSSttttrrrriiiinnnngggg(3) for more information on the creation
                    and structure of compound strings.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss
                    for this resource returns the list items
                    themselves, not a copy of the list items.  The
                    application must not free the returned items.

          XXXXmmmmNNNNlllliiiissssttttMMMMaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
                    Specifies the height of the margin between the
                    list border and the items.

          XXXXmmmmNNNNlllliiiissssttttMMMMaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
                    Specifies the width of the margin between the list
                    border and the items.

          XXXXmmmmNNNNlllliiiissssttttSSSSiiiizzzzeeeePPPPoooolllliiiiccccyyyy
                    Controls the reaction of the List when an item
                    grows horizontally beyond the current size of the
                    list work area.  If the value is XXXXmmmmCCCCOOOONNNNSSSSTTTTAAAANNNNTTTT, the
                    list viewing area does not grow, and a horizontal
                    ScrollBar is added for a List whose parent is a
                    ScrolledWindow.  If this resource is set to
                    XXXXmmmmVVVVAAAARRRRIIIIAAAABBBBLLLLEEEE, the List grows to match the size of
                    the longest item, and no horizontal ScrollBar
                    appears.

                    When the value of this resource is
                    XXXXmmmmRRRREEEESSSSIIIIZZZZEEEE____IIIIFFFF____PPPPOOOOSSSSSSSSIIIIBBBBLLLLEEEE, the List attempts to grow or
                    shrink to match the width of the widest item.  If
                    it cannot grow to match the widest size, a
                    horizontal ScrollBar is added for a List whose
                    parent is a ScrolledWindow if the longest item is
                    wider than the list viewing area.

                    The size policy must be set at the time the List
                    widget is created.  It cannot be changed at a
                    later time through XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss.

          XXXXmmmmNNNNlllliiiissssttttSSSSppppaaaacccciiiinnnngggg
                    Specifies the spacing between list items.  This
                    spacing increases by the value of the
                    XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssssresource in Primitive.

          XXXXmmmmNNNNmmmmaaaattttcccchhhhBBBBeeeehhhhaaaavvvviiiioooorrrr
                    Specifies the matching behavior followed by
                    XmList.  The current values are XXXXmmmmNNNNOOOONNNNEEEE and
                    XXXXmmmmQQQQUUUUIIIICCCCKKKK____NNNNAAAAVVVVIIIIGGGGAAAATTTTEEEE, as follows:



     Page 8                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    XXXXmmmmNNNNOOOONNNNEEEE    Specifies that the typed in characters
                              are ignored.

                    XXXXmmmmQQQQUUUUIIIICCCCKKKK____NNNNAAAAVVVVIIIIGGGGAAAATTTTEEEE
                              Specifies that 1-character navigation
                              shall be supported when List has focus.
                              If the typed character is the initial
                              character of some set of items in List,
                              the first of those items following the
                              current item will be navigated to
                              (become the current item). If all such
                              items precede the current item, the
                              first such item becomes the current
                              item.  Subsequently, typing the same
                              character will cyclically navigate among
                              the items with the same first character.

          XXXXmmmmNNNNmmmmuuuullllttttiiiipppplllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks that is called when
                    an item is selected in multiple selection mode.
                    The reason is XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT.

          XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp
                    Specifies whether XmContainer takes ownership of
                    the Primary selection when a selection is made
                    inside it. This resource can take the following
                    values:

                    XXXXmmmmOOOOWWWWNNNN____NNNNEEEEVVVVEEEERRRR
                              Never takes ownership.

                    XXXXmmmmOOOOWWWWNNNN____AAAALLLLWWWWAAAAYYYYSSSS
                              Always takes ownership.

                    XXXXmmmmOOOOWWWWNNNN____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE
                              Only takes ownership is more than one
                              element has been selected.

                    XXXXmmmmOOOOWWWWNNNN____PPPPOOOOSSSSSSSSIIIIBBBBLLLLEEEE____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE
                              Only takes ownership if more than one
                              element can be selected at a time.

          XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
                    Specifies the render table associated with the
                    list items. The render table is used in
                    conjunction with the XXXXmmmmNNNNvvvviiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnnttttresource
                    to determine the height of the List widget. If
                    this value is NULL at initialization, List
                    searches its parent hierarchy for a widget that
                    holds the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait.  If such
                    an ancestor is found, the render table is
                    initialized to the XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of



     Page 9                                         (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    the ancestor widget. If no such widget is found,
                    the default is implementation dependent. If a font
                    list and a render table are both specified, the
                    render table will take precedence. Refer to
                    XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on the
                    creation and structure of a render table.

          XXXXmmmmNNNNssssccccrrrroooollllllllBBBBaaaarrrrDDDDiiiissssppppllllaaaayyyyPPPPoooolllliiiiccccyyyy
                    Controls the display of vertical ScrollBars in a
                    List whose parent is a ScrolledWindow.  When the
                    value of this resource is XXXXmmmmAAAASSSS____NNNNEEEEEEEEDDDDEEEEDDDD, a vertical
                    ScrollBar is displayed only when the number of
                    items in the List exceeds the number of visible
                    items.  When the value is XXXXmmmmSSSSTTTTAAAATTTTIIIICCCC, a vertical
                    ScrollBar is always displayed.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttCCCCoooolllloooorrrr
                    Allows the application to specify the color of the
                    background rectangle that indicates selected text.
                    It takes two values:

                    XXXXmmmmDDDDEEEEFFFFAAAAUUUULLLLTTTT____SSSSEEEELLLLEEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR
                              Causes the select color to be set to a
                              color between the background and the
                              bottom shadow color.

                    XXXXmmmmRRRREEEEVVVVEEEERRRRSSSSEEEEDDDD____GGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRRSSSS
                              Forces the select color to the
                              foreground color and the color of any
                              text rendered over the select color to
                              be in the background color.

                    _H_I_G_H_L_I_G_H_T__C_O_L_O_R
                              Forces the fill color to use the
                              highlight color.

          XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmCCCCoooouuuunnnntttt
                    Specifies the number of strings in the selected
                    items list.  The value must be the number of items
                    in XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss and must not be negative.

          XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss
                    Points to an array of compound strings that
                    represents the list items that are currently
                    selected, either by the user or by the
                    application.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for this resource
                    returns the list items themselves, not a copy of
                    the list items.  The application must not free the
                    returned items or the array.

                    Setting XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss selects those list items
                    that exactly match items in the given



     Page 10                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss list. There may be additional
                    items in XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss that do not match items
                    in the list. These items remain until
                    XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss is updated.  If XXXXmmmmNNNNiiiitttteeeemmmmssss is
                    changed such that the list now contains items
                    matching previously unmatched items in
                    XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss, those new items will also appear
                    selected.

                    Any user interaction with the list that causes at
                    least one item to be selected or deselected and
                    any call to XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeAAAAllllllllIIIItttteeeemmmmssss,
                    XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmm, XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmmssss,
                    XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmmssssPPPPoooossss, XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeePPPPoooossss,
                    XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeePPPPoooossssiiiittttiiiioooonnnnssss, XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttAAAAllllllllIIIItttteeeemmmmssss,
                    XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttIIIItttteeeemmmm, XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttPPPPoooossss,
                    XXXXmmmmLLLLiiiissssttttSSSSeeeelllleeeeccccttttIIIItttteeeemmmm, XXXXmmmmLLLLiiiissssttttSSSSeeeelllleeeeccccttttPPPPoooossss, or
                    XXXXmmmmLLLLiiiissssttttUUUUppppddddaaaatttteeeeSSSSeeeelllleeeecccctttteeeeddddLLLLiiiisssstttt cause XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss to
                    be updated immediately to exactly reflect the
                    visual state of the list.  Calls to any other
                    XXXXmmmmLLLLiiiisssstttt functions do not affect XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddIIIItttteeeemmmmssss.

          XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddPPPPoooossssiiiittttiiiioooonnnnCCCCoooouuuunnnntttt
                    Specifies the number of positions in the selected
                    positions list.  The value must be the number of
                    items in XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddPPPPoooossssiiiittttiiiioooonnnnssss

          XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddPPPPoooossssiiiittttiiiioooonnnnssss
                    Points to an array of the positions of the
                    selected items in the List.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for this
                    resource returns the list items themselves, not a
                    copy of the list items. The application must not
                    free the returned items or the array.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnMMMMooooddddeeee
                    Defines what effect keyboard navigations have on
                    selection. The valid modes are:

                    XXXXmmmmAAAADDDDDDDD____MMMMOOOODDDDEEEE
                              Allows no navigation operations to have
                              effect on selection, and <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>
                              toggles the selection state of the item
                              at the location cursor without
                              deselecting any other selected items,
                              except in Single Select. However, the
                              widget cannot be put into add mode if
                              the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy resource is an
                              incompatible mode (XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                              cannot be XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT).

                    XXXXmmmmNNNNOOOORRRRMMMMAAAALLLL____MMMMOOOODDDDEEEE
                              Allows navigation operations and



     Page 11                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                              <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> to select the item at the
                              location cursor and deselect any other
                              selected items. However, the widget
                              cannot be put into normal mode if the
                              XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy resource is an
                              incompatible mode (XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                              cannot be XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
                              XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT).

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                    Defines the interpretation of the selection
                    action. This can be one of the following:

                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
                              Allows only single selections

                    XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
                              Allows multiple selections

                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
                              Allows extended selections

                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
                              Allows drag-and-browse functionality

          XXXXmmmmNNNNssssiiiinnnngggglllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks that is called when
                    an item is selected in single selection mode. The
                    reason is XXXXmmmmCCCCRRRR____SSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT.

          XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
                    Is a synthetic resource for setting
                    XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.  The values for this resource
                    are XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____LLLL____TTTTOOOO____RRRR and
                    XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____RRRR____TTTTOOOO____LLLL. Refer to the
                    XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource description. The
                    XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource is obsoleted by
                    XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn, but is kept here for backward
                    compatibility.

          XXXXmmmmNNNNttttooooppppIIIItttteeeemmmmPPPPoooossssiiiittttiiiioooonnnn
                    Specifies the position of the item that is the
                    first visible item in the list.  Setting this
                    resource is equivalent to calling the
                    XXXXmmmmLLLLiiiissssttttSSSSeeeettttPPPPoooossssfunction.  The position of the first
                    item in the list is 1; the position of the second
                    item is 2; and so on.  A position of 0 (zero)
                    specifies the last item in the list.  The value
                    must not be negative.

          XXXXmmmmNNNNvvvviiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnntttt
                    Specifies the number of items that can fit in the



     Page 12                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    visible space of the list work area. The List uses
                    this value to determine its height.  The value
                    must be greater than 0 (zero).

        IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
          List inherits behavior and resources from the superclasses
          described in the following tables.  For a complete
          description of each resource, refer to the reference page
          for that superclass.

                                               XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNbottomShadowColor      XmCBottomShadowColor    Pixel              dynamic                CSG
          XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
          XmNconvertCallback        XmCCallback             XtCallbackList     NULL                   C
          XmNforeground             XmCForeground           Pixel              dynamic                CSG
          XmNhelpCallback           XmCCallback             XtCallbackList     NULL                   C
          XmNhighlightColor         XmCHighlightColor       Pixel              dynamic                CSG
          XmNhighlightOnEnter       XmCHighlightOnEnter     Boolean            False                  CSG
          XmNhighlightPixmap        XmCHighlightPixmap      Pixmap             dynamic                CSG
          XmNhighlightThickness     XmCHighlightThickness   Dimension          2                      CSG
          XmNlayoutDirection        XmCLayoutDirection      XmDirection        dynamic                CG
          XmNnavigationType         XmCNavigationType       XmNavigationType   XmTAB_GROUP            CSG
          XmNpopupHandlerCallback   XmCCallback             XtCallbackList     NULL                   C
          XmNshadowThickness        XmCShadowThickness      Dimension          2                      CSG
          XmNtopShadowColor         XmCTopShadowColor       Pixel              dynamic                CSG
          XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap             dynamic                CSG
          XmNtraversalOn            XmCTraversalOn          Boolean            True                   CSG
          XmNunitType               XmCUnitType             unsigned char      dynamic                CSG
          XmNuserData               XmCUserData             XtPointer          NULL                   CSG

                                                        CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
          XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
          XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
          XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
          XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
          XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
          XmNdepth                        XmCDepth                        int              dynamic                CG
          XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
          XmNheight                       XmCHeight                       Dimension        dynamic                CSG
          XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
          XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
          XmNscreen                       XmCScreen                       Screen *         dynamic                CG
          XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
          XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
          XmNwidth                        XmCWidth                        Dimension        dynamic                CSG





     Page 13                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          XmNx                            XmCPosition                     Position         0                      CSG
          XmNy                            XmCPosition                     Position         0                      CSG

        CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
          List defines a new callback structure. The application must
          first look at the reason field and use only the structure
          members that are valid for that particular reason, because
          not all fields are relevant for every possible reason. The
          callback structure is defined as follows:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  XmString _i_t_e_m;
                  int _i_t_e_m__l_e_n_g_t_h;
                  int _i_t_e_m__p_o_s_i_t_i_o_n;
                  XmString *_s_e_l_e_c_t_e_d__i_t_e_m_s;
                  int _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t;
                  int *_s_e_l_e_c_t_e_d__i_t_e_m__p_o_s_i_t_i_o_n_s;
                  char _s_e_l_e_c_t_i_o_n__t_y_p_e;
                  unsigned char _a_u_t_o__s_e_l_e_c_t_i_o_n__t_y_p_e;
          } XmListCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL.

          _i_t_e_m      The last item selected at the time of the _e_v_e_n_t
                    that caused the callback.  _i_t_e_m points to a
                    temporary storage space that is reused after the
                    callback is finished.  Therefore, if an
                    application needs to save the item, it should copy
                    the item into its own data space.

          _i_t_e_m__l_e_n_g_t_h
                    The length in bytes of _i_t_e_m.  This member is
                    obsolete and exists for compatibility with earlier
                    releases.

          _i_t_e_m__p_o_s_i_t_i_o_n
                    The position (plus one) of _i_t_e_m in the List's
                    XXXXmmmmNNNNiiiitttteeeemmmmssss array.  An _i_t_e_m__p_o_s_i_t_i_o_n value of one
                    symbolizes the first element in the list.

          _s_e_l_e_c_t_e_d__i_t_e_m_s
                    A list of items selected at the time of the _e_v_e_n_t
                    that caused the callback.  _s_e_l_e_c_t_e_d__i_t_e_m_s points
                    to a temporary storage space that is reused after
                    the callback is finished.  Therefore, if an
                    application needs to save the selected list, it



     Page 14                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    should copy the list into its own data space.

          _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t
                    The number of items in the _s_e_l_e_c_t_e_d__i_t_e_m_s list.
                    This number must be non-negative.

          _s_e_l_e_c_t_e_d__i_t_e_m__p_o_s_i_t_i_o_n_s
                    An array of integers, one for each selected item,
                    representing the position of each selected item in
                    the List's XXXXmmmmNNNNiiiitttteeeemmmmssss array.
                    _s_e_l_e_c_t_e_d__i_t_e_m__p_o_s_i_t_i_o_n_s points to a temporary
                    storage space that is reused after the callback is
                    finished.  Therefore, if an application needs to
                    save this array, it should copy the array into its
                    own data space.

          _s_e_l_e_c_t_i_o_n__t_y_p_e
                    Indicates that the most recent extended selection
                    was the initial selection (XXXXmmmmIIIINNNNIIIITTTTIIIIAAAALLLL), a
                    modification of an existing selection
                    (XXXXmmmmMMMMOOOODDDDIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN), or an additional noncontiguous
                    selection (XXXXmmmmAAAADDDDDDDDIIIITTTTIIIIOOOONNNN).

          aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee
                    Indicates the type of automatic selection
                    callback. The types of callbacks include the
                    following:

                    XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN
                              Indicates the beginning of automatic
                              selection.

                    XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN
                              Indicates that there is a button drag
                              selection.

                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL
                              Indicates that the new selection is
                              cancelled.

                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE
                              Indicates that the currently selected
                              item matches the initial item.

                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE
                              Indicates that the currently selected
                              item does not match the initial item.

          The following table describes the reasons for which the
          individual callback structure fields are valid.
          RRRReeeeaaaassssoooonnnn                 VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss
                                 _r_e_a_s_o_n, _e_v_e_n_t, _i_t_e_m,



     Page 15                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                                 _i_t_e_m__l_e_n_g_t_h,
                                 _i_t_e_m__p_o_s_i_t_i_o_n





















































     Page 16                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          XmCR_DEFAULT_ACTION






















































     Page 17                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          XmCR_SINGLE_SELECT






















































     Page 18                                        (printed 10/24/98)






     XXXXXXXXmmmmmmmmLLLLLLLLiiiiiiiisssssssstttttttt((((((((33333333XXXXXXXX))))))))                UUUUUUUUNNNNNNNNIIIIIIIIXXXXXXXX SSSSSSSSyyyyyyyysssssssstttttttteeeeeeeemmmmmmmm VVVVVVVV                XXXXXXXXmmmmmmmmLLLLLLLLiiiiiiiisssssssstttttttt((((((((33333333XXXXXXXX))))))))



     XmCR_BROWSE_SELECT     _r_e_a_s_o_r_n_e,_a_s_e_o_v_n_e,_n_t_e,_v_e_i_n_t_t_e,_m,_i_t_e_m,
                            _i_t_e_m__i_l_t_e_e_n_m_g__t_l_h_e,_n_g_t_h,
                            _i_t_e_m__i_p_t_o_e_s_m_i__t_p_i_o_o_s_n_i_t_i_o_n,
     XmCR_MULTIPLE_SELECT   _r_e_a_s_o_s_n_e,_l_e_e_c_v_t_e_e_n_d_t_,_i_t_i_e_t_m_e_s_m,,
                            _i_t_e_m__s_l_e_e_l_n_e_g_c_t_t_h_e,_d__i_t_e_m__c_o_u_n_t,
                            _i_t_e_m__s_p_e_o_l_s_e_i_c_t_t_i_e_o_d_n_,_i_t_e_m__p_o_s_i_t_i_o_n_s
                            _s_e_l_e_c_t_e_d__i_t_e_m_s,
                            _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t,
                            _s_e_l_e_c_t_e_d__i_t_e_m__p_o_s_i_t_i_o_n_s
     XmCR_EXTENDED_SELECT   _r_e_a_s_o_n, _e_v_e_n_t, _i_t_e_m,
                            _i_t_e_m__l_e_n_g_t_h,
                            _i_t_e_m__p_o_s_i_t_i_o_n,
                            _s_e_l_e_c_t_e_d__i_t_e_m_s,
                            _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t,
                            _s_e_l_e_c_t_e_d__i_t_e_m__p_o_s_i_t_i_o_n_s,
                            _s_e_l_e_c_t_i_o_n__t_y_p_e

          A pointer to the following callback structure is passed to
          the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  Atom _s_e_l_e_c_t_i_o_n;
                  XtEnum _o_p_e_r_a_t_i_o_n;
                  int _f_l_a_g_s;
                  XtPointer _t_r_a_n_s_f_e_r__i_d;
                  XtPointer _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a;
                  XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
                  Time _t_i_m_e;
          } XmDestinationCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL.

          _s_e_l_e_c_t_i_o_n Indicates the selection for which data transfer is
                    being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
                    _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.

          _o_p_e_r_a_t_i_o_n Indicates the type of transfer operation
                    requested.

                       +o  When the selection is _P_R_I_M_A_R_Y, possible
                          values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, and XXXXmmmmLLLLIIIINNNNKKKK.

                       +o  When the selection is _S_E_C_O_N_D_A_R_Y or
                          _C_L_I_P_B_O_A_R_D, possible values are XXXXmmmmCCCCOOOOPPPPYYYY and
                          XXXXmmmmLLLLIIIINNNNKKKK.




     Page 19                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                       +o  When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, possible
                          values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and
                          XXXXmmmmOOOOTTTTHHHHEEEERRRR.  A value of XXXXmmmmOOOOTTTTHHHHEEEERRRR means that the
                          callback procedure must get further
                          information from the
                          XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt in the
                          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member.

          _f_l_a_g_s     Indicates whether or not the destination widget is
                    also the source of the data to be transferred.
                    Following are the possible values:

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
                              The destination widget is not the source
                              of the data to be transferred.

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
                              The destination widget is the source of
                              the data to be transferred.

          ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd
                    Serves as a unique ID to identify the transfer
                    transaction.

          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a
                    Contains information about the destination.  When
                    the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, the callback
                    procedures are called by the drop site's
                    XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc, and _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais a pointer to
                    the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
                    XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc procedure.  When the selection is
                    _S_E_C_O_N_D_A_R_Y, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is an Atom
                    representing a target recommmended by the
                    selection owner for use in converting the
                    selection.  Otherwise, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is NULL.

          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
                    Contains information about the location where data
                    is to be transferred.  The value is always NULL
                    when the selection is _S_E_C_O_N_D_A_R_Y or _C_L_I_P_B_O_A_R_D.  If
                    the value is NULL, the data is to be inserted at
                    the widget's cursor position.  Otherwise, the
                    value is an integer representing the position in
                    the List where the items are to be transferred.  A
                    value of 1 makes the first new item the first item
                    in the list; a value of 2 makes it the second
                    item; and so on.  Once _X_m_T_r_a_n_s_f_e_r_D_o_n_e procedures
                    start to be called, llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa will no longer
                    be stable.

          _t_i_m_e      Indicates the time when the transfer operation
                    began.



     Page 20                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



        TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
          XXXXmmmmLLLLiiiisssstttt includes translations from Primitive.  The XXXXmmmmLLLLiiiisssstttt
          translations are described in the following list.

          The following key names are listed in the X standard key
          event translation table syntax.  This format is the one used
          by Motif to specify the widget actions corresponding to a
          given key.  A brief overview of the format is provided under
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
          format, please refer to the X Toolkit Instrinsics
          Documentation.

          <<<<BBBBttttnnnn1111>>>><<<<MMMMoooottttiiiioooonnnn>>>>:
                    ListButtonMotion()

          ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    ListBeginExtend()

          ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    ListEndExtend()

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    ListBeginToggle()

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    ListEndToggle()

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    ListBeginSelect()

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    ListEndSelect()

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
                    ListProcessDrag()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    ListBeginDataExtend()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    ListBeginData()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    ListBeginLine()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    ListEndDataExtend()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    ListEndData()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:



     Page 21                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    ListEndLine()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
                    ListLeftPage()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    ListLeftPage()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    ListPrevPage()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
                    ListRightPage()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    ListRightPage()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    ListNextPage()

          ssss <<<<KKKKeeeeyyyyDDDDoooowwwwnnnn>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>::::
                    ListKbdBeginExtend()

          ::::<<<<KKKKeeeeyyyyDDDDoooowwwwnnnn>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    ListKbdBeginSelect()

          ::::ssss <<<<KKKKeeeeyyyyUUUUpppp>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    ListKbdEndExtend()

          ::::<<<<KKKKeeeeyyyyUUUUpppp>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    ListKbdEndSelect()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeeccccttttAAAAllllllll>>>>:
                    ListKbdSelectAll()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll>>>>:
                    ListKbdDeSelectAll()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
                    ListKbdActivate()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>:
                    ListAddMode()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
                    PrimitiveHelp()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
                    ListKbdCancel()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    ListLeftPage()



     Page 22                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    ListLeftChar()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    ListRightPage()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    ListRightChar()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    ListExtendPrevItem()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    ListPrevItem()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    ListExtendNextItem()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    ListNextItem()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    ListCopyToClipboard()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    ListCopyToClipboard()

          ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh:
                    ListKbdSelectAll()

          ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh:
                    ListKbdDeSelectAll()

          ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    PrimitivePrevTabGroup()

          ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    PrimitiveNextTabGroup()

          ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
                    ListKbdActivate()

          ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyyDDDDoooowwwwnnnn>>>>ssssppppaaaacccceeee:
                    ListKbdBeginSelect()

          ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyyUUUUpppp>>>>ssssppppaaaacccceeee:
                    ListKbdEndSelect()

          ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyyDDDDoooowwwwnnnn>>>>ssssppppaaaacccceeee:
                    ListKbdBeginExtend()

          ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyyUUUUpppp>>>>ssssppppaaaacccceeee:



     Page 23                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    ListKbdEndExtend()

          <<<<KKKKeeeeyyyy>>>>:    ListQuickNavigate()

          The List button event translations are modified when
          Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource does not have a
          value of XXXXmmmmOOOOFFFFFFFF (in other words, it is either
          _X_m_B_U_T_T_O_N_2__T_R_A_N_S_F_E_R or _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T). This option allows
          the actions for selection and transfer to be integrated on
          <<<<BBBBttttnnnn1111>>>>, and the actions for extending the selection can be
          bound to <<<<BBBBttttnnnn2222>>>>. The actions for <<<<BBBBttttnnnn1111>>>> that are defined
          above still apply when the <<<<BBBBttttnnnn1111>>>> event occurs over text
          that is not selected. The following actions apply when the
          <<<<BBBBttttnnnn1111>>>> event occurs over text that is selected:

          <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>::::
                    ListProcessBtn1(_L_i_s_t_B_u_t_t_o_n_M_o_t_i_o_n)

          ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>
                    ListProcessBtn1(_L_i_s_t_B_e_g_i_n_E_x_t_e_n_d)

          ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>
                    ListProcessBtn1(_L_i_s_t_E_n_d_E_x_t_e_n_d)

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>
                    ListProcessBtn1(_L_i_s_t_B_e_g_i_n_T_o_g_g_l_e)

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>
                    ListProcessBtn1(_L_i_s_t_E_n_d_T_o_g_g_l_e)

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>
                    ListProcessBtn1(_L_i_s_t_B_e_g_i_n_S_e_l_e_c_t)

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>
                    ListProcessBtn1(_L_i_s_t_E_n_d_S_e_l_e_c_t)

          When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of
          _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the following actions apply:

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>::::
                    ListProcessBtn2(_L_i_s_t_B_e_g_i_n_E_x_t_e_n_d)

          <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>::::
                    ListProcessBtn2(_L_i_s_t_B_u_t_t_o_n_M_o_t_i_o_n)

          <<<<BBBBttttnnnn2222UUUUpppp>>>>:::: ListProcessBtn2(_L_i_s_t_E_n_d_E_x_t_e_n_d)

        AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
          The XXXXmmmmLLLLiiiisssstttt action routines are described in the following
          list.  The current selection is always shown with inverted
          colors.




     Page 24                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          ListAddMode():
                    Toggles the state of Add Mode for keyboard
                    selection.

          ListBeginData():
                    Moves the location cursor to the first item in the
                    list.  In Normal Mode, this also deselects any
                    current selection, selects the first item in the
                    list, and calls the appropriate selection
                    callbacks (XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

          ListBeginDataExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
                    or XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action moves the
                    location cursor to the first item in the list.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection has been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the extended
                    selection was done; changes the selection state of
                    the first item and all items between it and the
                    current anchor point to the state of the item at
                    the current anchor point; calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

          ListBeginExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection has been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the extended
                    selection was done, and changes the selection
                    state of the item under the pointer and all items
                    between it and the current anchor point to the
                    state of the item at the current anchor point.  If
                    XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, this action
                    calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
                    The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.

          ListBeginLine():
                    Moves the horizontal scroll region to the
                    beginning of the line.

          ListBeginSelect():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    deselects any current selection and toggles the



     Page 25                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    selection state of the item under the pointer.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    deselects any current selection and selects the
                    item under the pointer.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn
                    is set to True, calls the
                    XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  The
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    toggles the selection state of the item under the
                    pointer.  Any previous selections remain.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action deselects any current selection,
                    selects the item under the pointer, and sets the
                    current anchor at that item.  If
                    XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, this action
                    calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
                    The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.

          ListBeginToggle():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action moves the current anchor to the item
                    under the pointer without changing the current
                    selection.  If the item is unselected, this action
                    selects it; if the item is selected, this action
                    unselects it.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to
                    True, this action calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

                    Otherwise, the list takes keyboard focus. No other
                    action occurs.  The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component
                    of the callback structure will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.

          ListButtonMotion():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    this action deselects any current selection and
                    selects the item under the pointer.  If
                    XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True and the
                    pointer has entered a new list item, this action
                    calls the XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkcallbacks.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection is being made and an extended selection
                    has previously been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the previous



     Page 26                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    extended selection was done and changes the
                    selection state of the item under the pointer and
                    all items between it and the current anchor point
                    to the state of the item at the current anchor
                    point.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True
                    and the pointer has entered a new list item, calls
                    the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkcallbacks.

                    If the pointer leaves a scrolled list, this action
                    scrolls the list in the direction of the pointer
                    motion.  The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the
                    callback structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN.

          ListCopyToClipboard()
                    Copies the content of the selected items to the
                    clipboard as a single compound string with each
                    item separated by a newline.  This action calls
                    the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, possibly
                    multiple times, for the _C_L_I_P_B_O_A_R_D selection.

          ListEndData():
                    Moves the location cursor to the last item in the
                    list.  In Normal Mode, this also deselects any
                    current selection, selects the last item in the
                    list, and calls the appropriate selection
                    callbacks (XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

          ListEndDataExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
                    or XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action moves the
                    location cursor to the last item in the list.

                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection has been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the extended
                    selection was done; changes the selection state of
                    the last item and all items between it and the
                    current anchor point to the state of the item at
                    the current anchor point; calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

          ListEndExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action moves the location cursor to the last
                    item selected or deselected and calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.




     Page 27                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, then the
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee field of the callback will be
                    valid. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTand the currently selected item
                    position matches the position of the item that was
                    selected before the browse selection began, or if
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
                    the set of currently selected item positions
                    matches the set of item positions selected before
                    the extended selection began, the callback will be
                    called with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  Otherwise, it will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.

          ListEndLine():
                    Moves the horizontal scroll region to the end of
                    the line.

          ListEndSelect():
                    This action moves the location cursor to the last
                    item selected or deselected and calls the
                    appropriate selection callbacks
                    (XXXXmmmmNNNNssssiiiinnnngggglllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                    is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNmmmmuuuullllttttiiiipppplllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

                    If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, then the
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee field of the callback will be
                    valid.  If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and the currently selected item
                    position matches the position of the item that was
                    selected before the brose selection began, or if
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
                    the set of currently selected item positions
                    matches the set of item positions selected before
                    the extended selection began, the callback will be
                    called with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  Otherwise, it will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.

          ListEndToggle():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    moves the location cursor to the last item
                    selected or deselected and calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

                    If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, then the



     Page 28                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee field of the callback will be
                    valid. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and the currently selected item
                    position matches the position of the item that was
                    selected before the browse selection began, or if
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
                    the set of currently selected item positions
                    matches the set of item positions selected before
                    the extended selection began, the callback will be
                    called with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  Otherwise, it will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.

          ListExtendNextItem():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection has been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the extended
                    selection was done; moves the location cursor to
                    the next item and changes the selection state of
                    the item and all items between it and the current
                    anchor point to the state of the item at the
                    current anchor point; calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

          ListExtendPrevItem():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action does the following:  If an extended
                    selection has been made from the current anchor
                    point, restores the selection state of the items
                    in that range to their state before the extended
                    selection was done; moves the location cursor to
                    the previous item and changes the selection state
                    of the item and all items between it and the
                    current anchor point to the state of the item at
                    the current anchor point; calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

          ListScrollCursorVertically(_p_e_r_c_e_n_t_a_g_e)))):
                    Scrolls the line containing the insertion cursor
                    vertically to an intermediate position in the
                    visible window based on an input percentage. A
                    value of 0 (zero) indicates the top of the window;
                    a value of 100, the bottom of the window. If this
                    action is called with no argument, the line
                    containing the insertion cursor is scrolled
                    vertically to a new position designated by the _y
                    event passed to the routine.

          ListKbdActivate():
                    Calls the callbacks for XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk.



     Page 29                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    If the List's parent is a manager, this action
                    passes the event to the parent.

          ListKbdBeginExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    does the following:  If an extended selection has
                    been made from the current anchor point, restores
                    the selection state of the items in that range to
                    their state before the extended selection was
                    done; changes the selection state of the item at
                    the location cursor and all items between it and
                    the current anchor point to the state of the item
                    at the current anchor point.  If
                    XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, this action
                    calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
                    The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN".

          ListKbdBeginSelect():
                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, deselects any current selection
                    and toggles the state of the item at the location
                    cursor.  The aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the
                    callback structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN".

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, deselects any current selection
                    and selects the item at the location cursor.  If
                    XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, calls the
                    XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, toggles the selection state of
                    the item at the location cursor.  Any previous
                    selections remain.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, moves the current anchor to the
                    item at the location cursor.  In Normal Mode, this
                    action deselects any current selection and selects
                    the item at the location cursor.  In Add Mode,
                    this action toggles the selection state of the
                    item at the location cursor and leaves the current
                    selection unchanged.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
                    set to True, this action calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  The
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN".

          ListKbdCancel():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTTand an extended selection is



     Page 30                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    being made from the current anchor point, this
                    action cancels the new selection and restores the
                    selection state of the items in that range to
                    their state before the extended selection was
                    done.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True,
                    this action calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks; otherwise, if the parent is a manager,
                    it passes the event to the parent.  The
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee component of the callback
                    structure will be set to XXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL".

          ListKbdDeSelectAll():
                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, or
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT in Add Mode, this action
                    deselects all items in the list.  If the
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT in
                    Normal Mode, this action deselects all items in
                    the list (except the item at the location cursor
                    if the shell's XXXXmmmmNNNNkkkkeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussssPPPPoooolllliiiiccccyyyy is
                    XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT).  This action also calls the
                    appropriate selection callbacks
                    (XXXXmmmmNNNNssssiiiinnnngggglllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNmmmmuuuullllttttiiiipppplllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

          ListKbdEndExtend():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT,
                    this action calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks.

                    If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, then the
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee field of the callback will be
                    valid. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and the currently selected item
                    position matches the position of the item that was
                    selected before the browse selection began, or if
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
                    the set of currently selected item positions
                    matches the set of item positions selected before
                    the extended selection began, the callback will be
                    called with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  Otherwise, it will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.

          ListKbdEndSelect():
                    Calls the appropriate selection callbacks
                    (XXXXmmmmNNNNssssiiiinnnngggglllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,



     Page 31                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                    is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNmmmmuuuullllttttiiiipppplllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

                    If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is set to True, then the
                    aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee field of the callback will be
                    valid. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and the currently selected item
                    position matches the position of the item that was
                    selected before the browse selection began, or if
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
                    the set of currently selected item positions
                    matches the set of item positions selected before
                    the extended selection began, the callback will be
                    called with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  Otherwise, it will be set to
                    XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.

          ListKbdSelectAll():
                    If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action selects the item at
                    the location cursor.  If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set
                    to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, it
                    selects all items in the list.  This action also
                    calls the appropriate selection callbacks
                    (XXXXmmmmNNNNssssiiiinnnngggglllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
                    is set to XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNmmmmuuuullllttttiiiipppplllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT,
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk when
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT).

          ListLeftChar():
                    Scrolls the list one character to the left.

          ListLeftPage():
                    Scrolls the list one page to the left.

          ListNextItem():
                    Moves the location cursor to the next item in the
                    list.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action also selects the next
                    item, deselects any current selection, and calls
                    the XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.




     Page 32                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action in Normal Mode also
                    selects the next item, deselects any current
                    selection, moves the current anchor to the next
                    item, and calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks.  In Add Mode, this action does not
                    affect the selection or the anchor.

          ListNextPage():
                    Scrolls the list to the next page, moving the
                    location cursor to a new item.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action also selects the new
                    item, deselects any current selection, and calls
                    the XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action in Normal Mode also
                    selects the new item, deselects any current
                    selection, moves the current anchor to the new
                    item, and calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks.  In Add Mode, this action does not
                    affect the selection or the anchor.

          ListPrevItem():
                    Moves the location cursor to the previous item in
                    the list.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action also selects the
                    previous item, deselects any current selection,
                    and calls the XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action in Normal Mode also
                    selects the previous item, deselects any current
                    selection, moves the current anchor to the
                    previous item, and calls the
                    XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  In Add
                    Mode, this action does not affect the selection or
                    the anchor.

          ListPrevPage():
                    Scrolls the list to the previous page, moving the
                    location cursor to a new item.

                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action also selects the new
                    item, deselects any current selection, and calls
                    the XXXXmmmmNNNNbbbbrrrroooowwwwsssseeeeSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.



     Page 33                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is set to
                    XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action in Normal Mode also
                    selects the new item, deselects any current
                    selection, moves the current anchor to the new
                    item, and calls the XXXXmmmmNNNNeeeexxxxtttteeeennnnddddeeeeddddSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    callbacks.  In Add Mode this action does not
                    affect the selection or the anchor.

          ListProcessBtn1(_s_t_r_i_n_g)
                    When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is
                    not XXXXmmmmOOOOFFFFFFFF, the actions for selection and transfer
                    are integrated on <<<<BBBBttttnnnn1111>>>>.  When the button is not
                    performing a transfer or drag, the action that is
                    performed depends on the value of _s_t_r_i_n_g, which
                    can be one of the following actions:

                       +o  LLLLiiiissssttttBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn

                       +o  LLLLiiiissssttttBBBBeeeeggggiiiinnnnEEEExxxxtttteeeennnndddd

                       +o  LLLLiiiissssttttEEEEnnnnddddEEEExxxxtttteeeennnndddd

                       +o  LLLLiiiissssttttBBBBeeeeggggiiiinnnnTTTToooogggggggglllleeee

                       +o  LLLLiiiissssttttEEEEnnnnddddTTTToooogggggggglllleeee

                       +o  LLLLiiiissssttttBBBBeeeeggggiiiinnnnSSSSeeeelllleeeecccctttt

                       +o  LLLLiiiissssttttEEEEnnnnddddSSSSeeeelllleeeecccctttt

          LLLLiiiissssttttPPPPrrrroooocccceeeessssssssBBBBttttnnnn2222
                    When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has
                    a value of _X_m_B_U_T_T_O_N_2__T_R_A_N_S_F_E_R, the actions for
                    extending selection are bound on <<<<BBBBttttnnnn2222>>>>, and a
                    drag starts immediately.  When Display's
                    XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of
                    _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the action that is performed
                    depends on the value of _s_t_r_i_n_g, which can be one
                    of the following actions:

                       +o  LLLLiiiissssttttBBBBeeeeggggiiiinnnnEEEExxxxtttteeeennnndddd

                       +o  LLLLiiiissssttttBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn

                       +o  LLLLiiiissssttttEEEEnnnnddddEEEExxxxtttteeeennnndddd

          ListProcessDrag():
                    Drags the content of one or more selected list
                    items.  Each item is separated by a newline.  If
                    BBBBTTTTrrrraaaannnnssssffffeeeerrrr is pressed on an unselected item, it
                    drags only that item, excluding any other selected
                    items.  This action sets the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc of the



     Page 34                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



                    DragContext to a function that calls the
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, possibly multiple
                    times, for the ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP selection.

          LLLLiiiissssttttQQQQuuuuiiiicccckkkkNNNNaaaavvvviiiiggggaaaatttteeee
                    Navigates to an item. When List's XXXXmmmmNNNNmmmmaaaattttcccchhhhBBBBeeeehhhhaaaavvvviiiioooorrrr
                    resource is XXXXmmmmQQQQUUUUIIIICCCCKKKK____NNNNAAAAVVVVIIIIGGGGAAAATTTTEEEE, this action uses 1-
                    character navigation to navigate. Refer to the
                    XXXXmmmmNNNNmmmmaaaattttcccchhhhBBBBeeeehhhhaaaavvvviiiioooorrrr resource for a description of how
                    this navigation works.

          ListRightChar():
                    Scrolls the list one character to the right.

          ListRightPage():
                    Scrolls the list one page to the right.

          PrimitiveHelp():
                    Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
                    exist. If there are no help callbacks for this
                    widget, this action calls the help callbacks for
                    the nearest ancestor that has them.

          PrimitiveNextTabGroup():
                    Moves the focus to the first item contained within
                    the next tab group. If the current tab group is
                    the last entry in the tab group list, it wraps to
                    the beginning of the tab group list.

          PrimitivePrevTabGroup():
                    Moves the focus to the first item contained within
                    the previous tab group.  If the beginning of the
                    tab group list is reached, it wraps to the end of
                    the tab group list.

        AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
          The List widget has the following additional behavior:

          <<<<DDDDoooouuuubbbblllleeee CCCClllliiiicccckkkk>>>>
                    If a button click is followed by another button
                    click within the time span specified by the
                    display's multiclick time, the List interprets
                    that as a double click and calls the callbacks for
                    XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk.  The item's colors
                    invert to indicate that it is selected.  The
                    XXXXmmmmNNNNddddoooouuuubbbblllleeeeCCCClllliiiicccckkkkIIIInnnntttteeeerrrrvvvvaaaallll resource can be used to
                    specify a time span that overrides the display's
                    multi-click time.

          <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
                    If the focus policy is Explicit, this action sets
                    the focus and draw the location cursor.



     Page 35                                        (printed 10/24/98)






     XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmLLLLiiiisssstttt((((3333XXXX))))



          <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
                    If the focus policy is Explicit, this action
                    removes the focus and erase the location cursor.

        VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).

     RRRREEEELLLLAAAATTTTEEEEDDDD
          CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeLLLLiiiisssstttt(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddLLLLiiiisssstttt(3),
          XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttCCCCrrrreeeeaaaatttteeee(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy(3),
          XXXXmmmmLLLLiiiissssttttAAAAddddddddIIIItttteeeemmmm(3), XXXXmmmmLLLLiiiissssttttAAAAddddddddIIIItttteeeemmmmssss(3),
          XXXXmmmmLLLLiiiissssttttAAAAddddddddIIIItttteeeemmmmUUUUnnnnsssseeeelllleeeecccctttteeeedddd(3), XXXXmmmmLLLLiiiissssttttAAAAddddddddIIIItttteeeemmmmssssUUUUnnnnsssseeeelllleeeecccctttteeeedddd(3),
          XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeAAAAllllllllIIIItttteeeemmmmssss(3), XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmm(3),
          XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmmssss(3), XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeeIIIItttteeeemmmmssssPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeePPPPoooossss(3), XXXXmmmmLLLLiiiissssttttDDDDeeeelllleeeetttteeeePPPPoooossssiiiittttiiiioooonnnnssss(3),
          XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttAAAAllllllllIIIItttteeeemmmmssss(3), XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttIIIItttteeeemmmm(3),
          XXXXmmmmLLLLiiiissssttttDDDDeeeesssseeeelllleeeeccccttttPPPPoooossss(3), _X_m_L_i_s_t_G_e_t_K_b_d_I_t_e_m_P_o_s
          XXXXmmmmLLLLiiiissssttttGGGGeeeettttMMMMaaaattttcccchhhhPPPPoooossss(3), XXXXmmmmLLLLiiiissssttttGGGGeeeettttSSSSeeeelllleeeecccctttteeeeddddPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttIIIItttteeeemmmmEEEExxxxiiiissssttttssss(3), XXXXmmmmLLLLiiiissssttttIIIItttteeeemmmmPPPPoooossss(3), XXXXmmmmLLLLiiiissssttttPPPPoooossssTTTTooooBBBBoooouuuunnnnddddssss(3),
          XXXXmmmmLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeeIIIItttteeeemmmmssss(3), XXXXmmmmLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeeIIIItttteeeemmmmssssPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeeIIIItttteeeemmmmssssPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeeIIIItttteeeemmmmssssPPPPoooossssUUUUnnnnsssseeeelllleeeecccctttteeeedddd(3),
          XXXXmmmmLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeeIIIItttteeeemmmmssssUUUUnnnnsssseeeelllleeeecccctttteeeedddd(3), XXXXmmmmLLLLiiiissssttttSSSSeeeelllleeeeccccttttIIIItttteeeemmmm(3),
          XXXXmmmmLLLLiiiissssttttSSSSeeeelllleeeeccccttttPPPPoooossss(3), XXXXmmmmLLLLiiiissssttttSSSSeeeettttAAAAddddddddMMMMooooddddeeee(3),
          XXXXmmmmLLLLiiiissssttttSSSSeeeettttBBBBoooottttttttoooommmmIIIItttteeeemmmm(3), XXXXmmmmLLLLiiiissssttttSSSSeeeettttBBBBoooottttttttoooommmmPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttSSSSeeeettttHHHHoooorrrriiiizzzzPPPPoooossss(3), XXXXmmmmLLLLiiiissssttttSSSSeeeettttIIIItttteeeemmmm(3),
          XXXXmmmmLLLLiiiissssttttSSSSeeeettttKKKKbbbbddddIIIItttteeeemmmmPPPPoooossss(3), XXXXmmmmLLLLiiiissssttttSSSSeeeettttPPPPoooossss(3),
          XXXXmmmmLLLLiiiissssttttUUUUppppddddaaaatttteeeeSSSSeeeelllleeeecccctttteeeeddddLLLLiiiisssstttt(3), XXXXmmmmLLLLiiiissssttttYYYYTTTTooooPPPPoooossss(3), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee(3)
          and XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3).
























     Page 36                                        (printed 10/24/98)